home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Topik / Topik - Disk 04 - Disk and Technical Stuff (19xx)(Topik Public Domain)(PD)[WB].zip / Topik - Disk 04 - Disk and Technical Stuff (19xx)(Topik Public Domain)(PD)[WB].adf / Dirmaster / DirMaster.doc < prev    next >
Text File  |  1989-06-21  |  36KB  |  1,046 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. DDDDD  IIIIII RRRRR   EEEEE   CCCC TTTTTTTT OOOO   RRRRR YY    YY
  10. DD  DD   II   RR  RR  EE     CC       TT   OO  OO  RR  RR YY  YY
  11. DD   DD  II   RR RR   EE    CC        TT  OO    OO RR RR   YYYY
  12. DD   DD  II   RRRR    EEEEE CC        TT  OO    OO RRRR     YY
  13. DD   DD  II   RR RR   EE    CC        TT  OO    OO RR RR    YY
  14. DD  DD   II   RR  RR  EE     CC       TT   OO  OO  RR  RR   YY
  15. DDDDD  IIIIII RR   RR EEEEE   CCCC    TT    OOOO   RR   RR  YY
  16.  
  17.  
  18.  
  19. MM     MM       AAA         SSSS     TTTTTTTT    EEEEE    RRRRR
  20. MMM   MMM      AA AA       SSS SS       TT       EE       RR  RR
  21. MM M M MM     AA   AA       SS          TT       EE       RR RR
  22. MM  M  MM    AAAAAAAAA       SSS        TT       EEEEE    RRRR
  23. MM     MM    AA     AA        SS        TT       EE       RR RR
  24. MM     MM    AA     AA     SS SSS       TT       EE       RR  RR
  25. MM     MM    AA     AA      SSSS        TT       EEEEE    RR   RR
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32. V     V EEEE RRR   SSS IIIIII  OO   N   N      111         111
  33. V     V EE   R RR SS     II   O  O  NN  N       11          11
  34.  V   V  EEEE RR    SSS   II  O    O N N N       11          11
  35.   V V   EE   R R     SS  II   O  O  N  NN       11    ..    11
  36.    V    EEEE R  R  SSS IIIIII  OO   N   N     111111  ..  111111
  37.     
  38.  
  39.  
  40.  
  41.  
  42.                                  By
  43.  
  44.  
  45.                           Gregory C. Peters
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.                           TABLE OF CONTENTS
  53.  
  54.   I. Preface.................................................1
  55.  
  56.  II. Overview................................................2
  57.  
  58. III. Getting Started
  59.      A. Main menu structure..................................3
  60.      B. Terminology..........................................3
  61.      C. Viewing an existing database.........................3
  62.      D. Building a new database..............................4
  63.      E. Finding a record.....................................4
  64.  
  65.  IV. Esoteric features
  66.      A. Extensions...........................................5
  67.      B. Categories and Comments..............................6
  68.      C. Name lists...........................................8
  69.      D. DOS utilities........................................9
  70.      E. The user-configurable environment....................9
  71.  
  72.   V. Quick Reference Section
  73.      A. Menu options........................................10
  74.      B. Keyboard functions..................................14
  75.      C. Imagery.............................................15
  76.  
  77.  VI. Shareware Plea
  78.      A. Shareware policy....................................20
  79.      B. Group rates.........................................20
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.                                 PREFACE                     page 1
  87.  
  88. If you are like me, you do not like reading user manuals, and if you
  89. are forced to, you just read the bare minimum .  With that in mind,
  90. this manual is not a comprehensive description of DirMaster and its
  91. features.  (Yes, a flimsy excuse for not providing complete
  92. documentation but I went to great pains to make DirMaster intuitive
  93. and easy to use.  Nor is FATHER TIME my best of my friends right now.) 
  94. Rather, the manual is written with the following objectives:
  95.  
  96.   1. Quick overview (blatant advertising)
  97.  
  98.   2. Getting started tutorial for beginners
  99.  
  100.   3. Description of the esoteric features for die-hards
  101.  
  102.   4. Quick Reference Section
  103.  
  104.  
  105. To print this manual, set up your printer as follows:
  106. 1. Lines per inch = 6.
  107. 2. Total characters per line = 70.
  108.  
  109.  
  110.  
  111.  
  112.                      DIRECTORY MASTER 1.1 OVERVIEW          page 2
  113.  
  114. Directory Master is the fastest, most comprehensive, most versatile
  115. disk cataloguer currently available for the Amiga.  Its major features
  116. include:
  117.  
  118. SPEED - DirMaster can sort 2000 records in about 7 seconds, or 8000
  119. records in 30 seconds, or 12000 records in about 44 seconds. 
  120. Furthermore, it will find any record in the display list almost
  121. instantaneously.
  122.  
  123. MEMORY EFFICIENCY - A 512K RAM Amiga can hold between 6000 - 7600
  124. records.  A 1.5M Amiga can hold up to 34000 records.  Maximum records
  125. is limited only by memory.  Plus, several options are devoted
  126. exclusively to packing more information into limited memory.
  127.  
  128. EASY TO USE - DirMaster is fully mouse and menu-driven.
  129.  
  130. UNIQUE COMPARE UTILITY - great for managing disk libraries.  DirMaster
  131. will produce a listing of all files on your disks but not in a
  132. database.  Plus, DirMaster gives you the option of consolidating the
  133. unique files onto fewer disks as well as allowing you to delete those
  134. files that are already in your database.
  135.  
  136. POWERFUL SORT FEATURE allows you to specify any combination and any
  137. order of up to 5 fields to use in sorting the display lists.
  138.  
  139. AMIGADOS UTILITIES that allow you to operate on all highlighted
  140. records in a disk at once, rather than one directory at a time.
  141.  
  142. SIX MAIN DISPLAY modes of displaying the database records. Plus you
  143. decide on any combination of the 5 fields to display.
  144.  
  145. EASY SCROLLING through the database via arrow and slider gadgets that
  146. continually update the screen display.
  147.  
  148. INPUT/OUTPUT and DISPLAY FILTERING - DirMaster lets you specify which
  149. records to use through its powerful and UNIQUE custom requesters.
  150.  
  151. MULTIPLE INPUT FORMATS - DirMaster can read in modified BBS listings,
  152. allowing you to use all of DirMaster's power to examine BBS downloads.
  153.  
  154. PRINTER SUPPORT - any list displayed by DirMaster can be sent to a
  155. printer or a file.
  156.  
  157. MULTIPLE RECORD SELECTION - any number of records may be selected
  158. simultaneously and operated on as a group.
  159.  
  160. FIND DUPLICATES option that allows you to find all of the duplicate
  161. records in the database.
  162.  
  163. COLORS - pick your favorite color combination out of 7 sets or define
  164. your own.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.                            GETTING STARTED                  page 3
  171.  
  172. All of DirMaster's features are grouped into 5 main categories
  173. (menus):
  174.  
  175. 1. Project   - options typically found in Amiga programs.
  176.  
  177. 2. Edit      - options to create, add to, and delete from databases.
  178.  
  179. 3. Utilities - options which expand DirMaster's usefulness.
  180.  
  181. 4. Display   - options that specify records for DirMaster to display.
  182.  
  183. 5. Configure - options to configure DirMaster as you want.
  184.  
  185.  
  186. When specific options are mentioned, the main menu will be specified,
  187. followed by the option and a sub-option (if applicable).
  188.  
  189.  
  190.                                TERMINOLOGY
  191.  
  192. 1. Record - any disk, directory, or file entry.
  193.  
  194. 2. Display list - the currently visible subset of records, as selected
  195. by the Display options.
  196.  
  197.  
  198.                      VIEWING AN EXISTING DATABASE
  199.  
  200. 1.  Use the Configure-Drive option to select the disk drive that
  201. contains the disk which has a DirMaster database.
  202.  
  203. 2.  Open the database with the Project-Open-All option.  Click the
  204. mouse on the database you wish to open, then select "OK".
  205.  
  206. 3.  The database is now loaded into DirMaster.  Use the Display
  207. options to select which portions of the database you would like to
  208. see.
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.                       BUILDING A NEW DATABASE               page 4
  216.  
  217. 1. Use the Configure-Drive option to select the disk drive that you
  218. will insert disks into.
  219.  
  220. 2. Select the Edit-Disk-Add option.  You will now be prompted to
  221. insert the first disk into the drive you selected.  DirMaster will
  222. print the current record being added to the database in the title area
  223. of the DirMaster screen.  When the disk is done being added to the
  224. database, DirMaster will display the disk name just added and wait for
  225. you to either enter another disk or select the CANCEL option.
  226.  
  227. 3. When you are done adding disks to the database, select the
  228. Configure- Credits-Database option to enter your name as the creator
  229. of the database.  This name will be stored with the database itself
  230. when the database is saved.  It may be viewed via the
  231. Project-About-Credits option.
  232.  
  233. 5.  Save the database by selecting the Project-Save As-w/o-
  234. categories/comments option.
  235.  
  236.  
  237.                           FINDING A RECORD
  238.  
  239. 1. Select a display option which would display that record if it
  240. exists.
  241.  
  242. 2. Select the Utilities-Find-Record(s) option.  A new window will
  243. appear that has several utilities (see the reference section for full
  244. details).  Type the EXACT name of the record you wish to find into the
  245. rectangular box.  If the record is in the database list you selected
  246. from the display option, it will be displayed in the lower part of the
  247. Find window.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.                           ESOTERIC FEATURES                 page 5
  255.  
  256. This portion of the manual is devoted to the (dare I say it ?) non-
  257. intuitive features of DirMaster.  Please note that the quick reference
  258. section may clear up questions concerning features that are not
  259. addressed here.
  260.  
  261.                              EXTENSIONS
  262.  
  263. The extensions options are provided mainly to conserve that elusive
  264. quantity that few people ever get enough of - MEMORY.  The
  265. Edit-delete- extensions option deletes all records in the display list
  266. which have the same path and same name, but different extensions.  It
  267. does not delete the alphabetically first record.  For example, suppose
  268. your database contains:
  269.  
  270.                  duIII.o
  271.                  duIII.c
  272.                  duIII
  273.                  duIII.info
  274.                  duIII.doc
  275.                  duIII.old
  276.                  duIII.ReadMe
  277.  
  278. ... all in the same path.  By deleting the extensions, you get rid of
  279. 6 records, (duIII is not deleted) without really losing that much
  280. information.
  281.  
  282. Deleting the extensions from the FISH0-90 database will result in a
  283. "savings" of approximately 2217 records.  This equates to about 22
  284. disks. Likewise, you can "save" about 662 records on the AMICUS1-16
  285. database.
  286.  
  287. You may achieve the same effect by opening a database (or appending a
  288. database) with the No extensions sub-option. These will simply ignore
  289. multiple extensions but will not delete them from the database itself.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                         CATEGORIES AND COMMENTS             page 6
  296.  
  297. DirMaster supports 2 completely user-definable fields which are called
  298. the comments and categories fields - although they may be used for
  299. anything you want.  For the sake of this discussion all comments
  300. concerning the "comment" field also apply to the "category" field,
  301. unless otherwise noted.  
  302.  
  303. The comment field is a character field of up to 60 characters.  Each
  304. comment is associated with a number (range 0 - 65535).  The numbers,
  305. not the individual comments,  are stored in the database itself. The
  306. comment numbers are then mapped to the actual comments by the file
  307. "DirMaster.comments" ("DirMaster.categories" for the category file).
  308.  
  309. The following options are available:
  310.  
  311. 1. Open-Comment file - reads in the file "Dirmaster.comments" which
  312. must be in your current directory.
  313.  
  314. 2. Save-with-comments/categories - this option stores the category and
  315. comment numbers in the database saved to disk.  IF YOU DO NOT SELECT
  316. THIS OPTION, NO COMMENT NUMBERS WILL BE SAVED.  Saving without comment
  317. numbers will decrease the database file size by 4 bytes per record.
  318.  
  319. 3. Resort - you may resort the display list by comment number if
  320. desired. This will group all records with identical comments or
  321. categories together.
  322.  
  323. 4. Display-Custom-Comments - this option will display all records
  324. whose comment field contains a specified string.  This is essentially
  325. a KEYWORD SEARCH option.  For example, you could use this option to
  326. display all records which have the string "graphic" in their comment
  327. description.  Likewise for "music" or "demo" or "directory utility",
  328. etc.  By the way, the keyword is NOT case sensitive, so "GraPHic" is
  329. identical to "graphic".
  330.  
  331. The comment and category fields are very useful, if you spend some
  332. time creating the appropriate files.  DirMaster does not provide
  333. direct comment entry, so you must create the comment file and directly
  334. insert the comment numbers into the database files.  Sorry, but I just
  335. did not have enough time to put this support into DirMaster. 
  336. Hopefully, someone will write a utility that simplifies this.
  337.  
  338. The "DirMaster.comments" file must have the following format:
  339.  
  340.                  101/nbr_records
  341.                  1/comment 1
  342.                  2/comment 2
  343.                  ...
  344. for example,
  345.                  101/3
  346.                  1/Directory utility program
  347.                  2/neat graphics demo, requires 1Meg to run
  348.                  3/communications program
  349.  
  350.  
  351.  
  352.  
  353.  
  354. NOTES:                                                      page 7
  355. 1. The first line in the "DirMaster.categories" file is:
  356. "100/nbr_records"
  357.  
  358. 2. Comment 0 is reserved as the NO COMMENT number.
  359.  
  360. 3. The numbers in front of the slashes must be sequential and may
  361. range from 1 to 65535.
  362.  
  363. The easiest way to insert comment numbers into the database file is by
  364. first saving the database with the comments/categories option.  This
  365. will give each record a comment of 0.  Then, using an editor or word
  366. processer, overwrite the 0 comments with the appropiate comment
  367. number.  For example, since the database format is:
  368.  
  369. type/level/size/date/category/comment/name
  370. i.e.
  371.  
  372.                 0/0/823744/3601/0/0/Work Disk
  373.  
  374. To assign comment number 3, to "Work Disk", the edited record would be
  375.  
  376.                 0/0/823744/3601/0/3/Work Disk
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.                             NAME LISTS                      page 8
  384.  
  385. This option lets you input a list of names (i.e from a BBS download)
  386. into DirMaster.  The size and date fields are set to 0, so the only
  387. useful information about the record is its name (unless you also use
  388. the comments or categories options).  BIX_28_DEC.namelist (on the
  389. DirMaster distribution disk) is an example namelist.
  390.  
  391. The name list format is:
  392.  
  393.                  200/nbr_records
  394.                  DiskName
  395.                  name1
  396.                  name2
  397.                  ...
  398.  
  399. for example,
  400.  
  401.                  200/12
  402.                  BIX_9-Nov-87_Partial
  403.                  asse10.doc
  404.                  asse10.lsp
  405.                  fuzzy.lsp
  406.                  msg.lsp
  407.                  ops5.lsp
  408.                  pc-lisp.arc
  409.                  qa.log
  410.                  qa.lsp
  411.  
  412. The disk name you choose should be informative.  The number of records
  413. can be anything.  DirMaster will fill in the correct number, if
  414. neccessary, but you must have a number in that field.  You should sort
  415. the list into alphabetical order (AmigaDos SORT command) if it is not
  416. already ordered.
  417.  
  418.  
  419.  
  420.  
  421.  
  422.                              DOS UTILITIES                  page 9
  423.  
  424. The DirMaster DOS utility options are very useful when you want to do
  425. the same thing to a number of files in different directories on a
  426. disk.  For example: deleting files, or showing picture files, or
  427. reading documentation files, or running new PD programs...  While
  428. several excellent PD directory utility programs are available, these
  429. typically restrict you to one directory at a time.
  430.  
  431. 1.  The first three DOS options are user-configurable via the
  432. Configure-Dos Utilities options.  They will send the option selected,
  433. followed by the highlighted file(s) to the CLI.  For example: "type
  434. beta.doc" can be sent to the CLI, at which time AmigaDos takes over,
  435. types the file in another window, then returns to DirMaster.  The
  436. program invoked by DirMaster must be in your current path - or be
  437. given a path in the command itself.
  438.  
  439. 2.  Dos-custom - this option sends a custom string and file name to
  440. the CLI.  It is used for commands you won't often use, and do not want
  441. to configure a special command for.
  442.  
  443. 3.  Dos-CLI - this opens a new CLI.  You must type "ENDCLI" (and
  444. "ENDCLI" must be in your path) before returning to DirMaster.
  445.  
  446.  
  447.                      USER CONFIGURABLE ENVIRONMENT
  448.  
  449. The user-configurable parameters are saved to the file
  450. "DirMaster.environment" upon program termination.  If this file is in
  451. your current directory on startup, then DirMaster will read its
  452. contents and configure itself accordingly.
  453.  
  454.  
  455.  
  456.  
  457.  
  458.                           REFERENCE SECTION                 page 10
  459.  
  460.                            MENU REFERENCE
  461.  
  462.                             PROJECT MENU
  463.  
  464. ABOUT
  465. 1. Directory Master - some notes on the current version
  466.  
  467. 2. Shareware - describes the shareware policy
  468.  
  469. 3. Credits - mentions some people who contributed to DirMaster
  470.  
  471. NEW - clears the current database from memory
  472.  
  473. OPEN - opens up various files that DirMaster uses
  474. 1. All - reads in all records in a database file
  475.  
  476. 2. No Extensions - reads in all records in a database file except for
  477. those records which have the same path and name, but different
  478. extensions (after the ".") 
  479.  
  480. 3. Custom - reads in a user-definable subset of the database
  481.  
  482. 4. Category File - reads in a category file
  483.  
  484. 5. Comment File - reads in a comment file
  485.  
  486. 6. Name List - reads in a name list
  487.  
  488. SAVE - saves the current database to the database originally opened 
  489. 1. with categories/comments - stores category and comment numbers in
  490. the saved database
  491.  
  492. 2. w/o categories/comments - does not store category and comment
  493. numbers in the saved database (saves 4 bytes per record)
  494.  
  495. SAVE AS - saves the current database to a user-specified file      
  496. 1. with categories/comments - stores category and comment numbers in
  497. the saved database
  498.  
  499. 2. w/o categories/comments - does not store category and comment
  500. numbers in the saved database (saves 4 bytes per record)
  501.  
  502. PRINT - prints the currently DISPLAYED records
  503. 1. to printer - prints the display list to the printer
  504.  
  505. 2. to file - prints the display list to a specified file
  506.  
  507. HELP - presents a 1 page help screen with some notes about DirMaster
  508.  
  509. QUIT - exits DirMaster
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.                               EDIT MENU                     page 11
  517.  
  518. DISK -
  519. 1. Add - adds the disk in the current drive to the database
  520.  
  521. 2. Update - deletes the highlighted disk from the database, then adds
  522. a disk with the same name in the current drive to the database
  523.  
  524. 3. Examine - reads the disk's contents in to memory and allows you to
  525. view its contents before adding it to the database
  526.  
  527. APPEND DATABASE - adds an existing database to one already in memory
  528. 1. All - appends all records
  529.  
  530. 2. No extensions - appends all records except for those records which
  531. have the same path and name, but different extensions (after the ".") 
  532.  
  533. 3. Custom - appends a user-definable subset 
  534.  
  535. 4. Name List - appends a name list
  536.  
  537. DELETE - deletes records from the database in memory
  538. 1. Highlighted Records - deletes all highlighted records and
  539. subrecords of highlighted records
  540.  
  541. 2. Extensions - deletes all records which have the same path and name,
  542. but different extensions (Does NOT delete the first matching record)
  543.  
  544. 3. Empty Disks - deletes all disks which have no sub-records
  545.  
  546. 4. Empty Directories - deletes all directories which have no
  547. sub-records
  548.  
  549. 5. Custom - deletes a user-definable subset of records
  550.  
  551.  
  552.                            UTILITIES MENU
  553.  
  554. FIND - searches for specific records or duplicate records
  555. 1. Records - finds a record in the current display list
  556.  
  557. 2. Duplicates - finds all duplicate records in the current display
  558. list
  559.  
  560. COMPARE - compares a disk to the current database in memory and
  561. supports several options for printing a list of unique files, copying
  562. unique files, and deleting matching files.
  563.  
  564. RESORT - Allows you to specify any combination and any order of 5
  565. fields (name, size, date, comment, category) as the sorting criteria
  566. for the display lists
  567.  
  568. UNHIGHLIGHT - unhighlights all highlighted records
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.                                                             page 12
  576. DOS - implements several AmigaDos utilities (must be in your CLI
  577. command path to use)
  578. 1. 1-3 - the first three are user-definable (see Configure Dos
  579. Utilities)
  580.  
  581. 4. custom - this is specified each time it is used 
  582.  
  583. 5. CLI - this option brings up a new CLI (you MUST type ENDCLI to get
  584. out of the CLI before returning to DirMaster)
  585.  
  586. STATUS - shows how many bytes are required to save and print the
  587. current database.  Also shows the bytes free on the current drive
  588.  
  589.  
  590.                             DISPLAY MENU
  591.  
  592. RECORDS - displays all records (disk, directory and file entries) in
  593. the database
  594.  
  595. DISKS - displays all disks in the database
  596. 1. No sub-records - displays disk names only
  597.  
  598. 2. Sub-records - displays disks and all sub-records for each disk
  599.  
  600. DIRECTORIES - displays all directories in the database
  601.  
  602. FILES - displays all files in the database
  603.  
  604. HIGHLIGHTED RECORDS - displays all highlighted records
  605.  
  606. PARENT - displays the parent and the parent's subrecords of the
  607. highlighted record selected
  608.  
  609. FIELDS - allows you to select any combination of 5 fields to display
  610.  
  611. CUSTOM - displays a user-definable subset of records
  612. 1. Names - displays a subset of names
  613.  
  614. 2. categories - displays the records whose categories contain the
  615. specified keyword
  616.  
  617. 3. comments - displays the records whose comments conatain the
  618. specified keyword
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.                             CONFIGURE MENU                  page 13
  626.  
  627. COLORS - allows you to pick the colors DirMaster uses
  628. 1. Predefined - lets you pick between any of 7 predefined color sets
  629.  
  630. 2. Custom - lets you pick any of 4096 colors for each of DirMaster's 8
  631. colors
  632.  
  633. DRIVE - allows you to specify the default drive that DirMaster uses
  634. 1. df0: - drive df0:
  635.  
  636. 2. df1: - drive df1:
  637.  
  638. 3. df2: - drive df2:
  639.  
  640. 4. custom - lets you specify any other drive
  641.  
  642. CREDITS - lets you specify names to be displayed in the About-Credits
  643. option
  644. 1. User - current user's name
  645.  
  646. 2. Database - name of whoever created the database
  647.  
  648. 3. Colors - name of whoever selected the custom colors
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.                          KEYBOARD FUNCTIONS                 page 14
  656.  
  657.                            MENU SHORTCUTS
  658.  
  659. Hold down the Right Amiga key and press the letter key specified
  660.  
  661.             A - Add Disk
  662.             C - Compare
  663.             D - Delete highlighted records
  664.             E - Examine disk
  665.             F - Find record(s)
  666.             H - Help
  667.             N - New
  668.             O - Open all
  669.             P - Print to printer
  670.             Q - Quit
  671.             R - Resort
  672.             S - Save with categories/comments
  673.             U - Unhighlight records
  674.  
  675.  
  676.                         MAIN DIRMASTER WINDOW
  677.  
  678. Up-arrow         = scroll display 1 record up
  679. Down-arrow       = scroll display 1 record down
  680. SHIFT-up-arrow   = scroll display 1 page (23 records) up
  681. SHIFT-down-arrow = scroll display 1 page (23 records) down
  682. ALT-up-arrow     = pposition display at beginning
  683. Alt-down-arrow   = position display at end
  684.  
  685.  
  686.                             FIND WINDOW
  687.  
  688. Up-arrow         = dispay previous records
  689. Down-arrow       = display next record
  690. SHIFT-up-arrow   = display record which is 1 page (1/30 of the total
  691. records in the display list) up from the current record
  692.  
  693. SHIFT-down arrow = display record which is 1 page (1/30 of the total
  694. records in the display list) down from the current record
  695.  
  696. ALT-up-arrow     = display the first record in the current display
  697. list
  698. ALT-down-arrow   = display the last record in the current display list
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.                              IMAGERY                        page 15
  706.  
  707. This section presents Directory Master's main imagery.
  708.  
  709. 1.  Color Sets
  710. ---------------------------------
  711. |                               |
  712. |          Color Sets           |
  713. |                               |
  714. |  SET 1  SET 2  SET 3  SET 4   |
  715. |                               |
  716. |  SET 5  SET 6  SET 7  CUSTOM  |
  717. |                               |
  718. |                               |
  719. |              OK               |
  720. |                               |
  721. ---------------------------------
  722.  
  723. You may select any of the seven predefined color sets, or the last
  724. entered custom color set.
  725.  
  726. 2.  Compare Requester
  727.  
  728. -----------------------------------------------
  729. |                                             |
  730. |              Compare Requester              |
  731. |                                             |
  732. |  Compare disk:  DF0:  DF1:                  |
  733. |                                             |
  734. |  Output to:  SCREEN  FILE  PRINTER          |
  735. |                                             |
  736. |  Fields:  NAME  SIZE  DATE                  |
  737. |                                             |
  738. |  Copy new files to another disk:   NO  YES  |
  739. |                                             |
  740. |  Delete matching files from disk:  NO  YES  |
  741. |                                             |
  742. |                                             |
  743. |            OK               CANCEL          |
  744. |                                             |
  745. -----------------------------------------------
  746.  
  747. The disks that are inserted into the selected drive will be compared
  748. (file by file) to the database in memory.  The files that are on the
  749. disk but not in the database will always be listed on the screen.  In
  750. addition, this file list may be sent to a text file and or the
  751. printer. Any combination of the compare fields may be used as long as
  752. at least one of them is selected.  You may also choose to copy all
  753. files that are on the disk but not in the database to another disk. 
  754. This is useful if you have a lot of duplication on your disks and want
  755. to consolidate the unique files onto fewer disks.  Finally, you may
  756. choose to delete all files from the compare disks which are already in
  757. the database.  All of these options operate simultaneously, so only
  758. one pass is made through the compare disk.
  759.  
  760.  
  761.  
  762.  
  763.  
  764. 3.  Custom ... Requester                                    page 16
  765.  
  766. -------------------------------------------------------------------
  767. |                                                                 |
  768. |                    Custom Display Requester                     |
  769. |                                                                 |
  770. |        Default = All                Wildcards = * and ?         |
  771. |                                                                 |
  772. |  Begin  XXXXXXXXXXXXXXXX    INCLUDE  XXXXXXXXXXXXXXXX  EXCLUDE  |
  773. |                                                                 |
  774. |  End    XXXXXXXXXXXXXXXX    INCLUDE  XXXXXXXXXXXXXXXX  EXCLUDE  |
  775. |                                                                 |
  776. |     INCLUDE   EXCLUDE       INCLUDE  XXXXXXXXXXXXXXXX  EXCLUDE  |
  777. |                                                                 |
  778. |                                                                 |
  779. |                  OK        RESET       CANCEL                   |
  780. |                                                                 |
  781. -------------------------------------------------------------------
  782.  
  783. This requester is used for custom displays, custom opens, custom
  784. appends, and custom deletes.  It gives you considerable power in
  785. defining a subset of records to operate on.  (None of the gadgets are
  786. case sensitive.)
  787.  
  788. The BEGIN and END gadgets define a range which may be INCLUDED or
  789. EXCLUDED. For example, setting BEGIN = "c" and END = "h" and selecting
  790. the INCLUDE gadget will define your range to be all records
  791. alphabetically greater than or equal to "c" and less than or equal to
  792. "h".  Selecting the EXCLUDE gadget with the same settings would give a
  793. range of all records less than or equal to "c" and all records greater
  794. than or equal to "h".  Selecting no range defaults to a range of ALL
  795. RECORDS.  After you choose the range of interest, the other gadgets
  796. define a subset of that range, where "*" is the multiple character
  797. wildcard and "?" is the one character wildcard symbol.  If you want to
  798. use all records within the specified range, then put an "*" in the
  799. first string gadget.  Otherwise, you may specify up to three strings
  800. to define a particular subset.  When the custom strings contradict
  801. each other, the top string has least priority and the bottom string
  802. has most priority.  Some examples:
  803.  
  804. INCLUDE *.c - includes all records w/i range that end with ".c"
  805.  
  806. INCLUDE d*  - includes all records w/i range that begin with "d"
  807.  
  808. INCLUDE ???*
  809. INCLUDE d*.c - includes all records w/i range that are 3 or more
  810. characters long and includes all records that begin with "d" and end
  811. with ".c"
  812.  
  813. INCLUDE *.?
  814. INCLUDE *.info
  815. EXCLUDE *.o - includes all records w/i range that end with "."
  816. followed by 1 and only 1 character unless that character is an "o". 
  817. Also includes all records that end with ".info".
  818.  
  819.  
  820.  
  821.  
  822.  
  823. 4.  Display Fields Requester                                page 17
  824.  
  825. -----------------------------------------------
  826. |                                             |
  827. |           Select  Display Fields            |
  828. |                                             |
  829. |  NAME  SIZE  DATE  PATH  CATEGORY  COMMENT  |
  830. |                                             |
  831. |    OK                               CANCEL  |
  832. |                                             |
  833. -----------------------------------------------
  834.  
  835. Determines which fields will be displayed and printed.  Any
  836. combination of fields may be selected, but the display of each record
  837. is limited to 1 line.
  838.  
  839. 5.  Find Duplicates Requester
  840.           
  841. -----------------------------------------
  842. |                                       |
  843. |      Select find duplicate fields     |
  844. |                                       |
  845. |  NAME  SIZE  DATE  CATEGORY  COMMENT  |
  846. |                                       |
  847. |    OK                         CANCEL  |
  848. |                                       |
  849. -----------------------------------------
  850.  
  851. When searching for duplicate records, only the fields selected above
  852. will be used as criteria.  Any combination of fields may be selected,
  853. as long as at least one field is specified. 
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860. 6. FIND WINDOW                                              page 18
  861.  
  862.                      Enter a record to find
  863.  
  864.            XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX            FIRST
  865.  
  866.            OK                CANCEL             QUIT
  867.                                                               PREVIOUS
  868.  
  869.                                                                 NEXT
  870.  
  871.            Scope:  DISPLAYED RECORDS                            LAST
  872.  
  873.  
  874.            Name:
  875.  
  876.            Size:
  877.  
  878.            Date:
  879.  
  880.            Path:
  881.  
  882.            Category:
  883.  
  884.            Comment:
  885.  
  886. This window is used to search for a specific record.  It may be
  887. reached via the Utilities-Find-Record option or by double-clicking on
  888. a file in the display list.  The search routine is very fast (less
  889. than a second to find a record in all databases tested - up to about
  890. 16000 records).
  891.  
  892. If you double clicked on a record, it is initially diplayed. Otherwise
  893. the top record in the previous display list is used.
  894.  
  895. OK       - attempts to find the record which is typed into the find
  896. gadget
  897. CANCEL   - returns to the display window, at its previous position
  898. QUIT     - returns to the display window, positioned at the found
  899. record
  900. FIRST    - displays the first record in the display list
  901. PREVIOUS - displays the previous record in the display list
  902. NEXT     - displays the next record in the display list
  903. LAST     - displays the last record in the display list
  904.  
  905. Keyboard functions
  906. Up-arrow         - same as PREVIOUS
  907. Down-arrow       - same as NEXT
  908. ALT-up-arrow     - same as FIRST
  909. ALT_down-arrow   - same as LAST
  910. SHIFT-up-arrow   - displays the record which is 1/30th of the display
  911. list above the current record
  912. SHIFT-down-arrow - displays the record which is 1/30th of the display
  913. list below the current record.
  914.  
  915.  
  916.  
  917.  
  918.  
  919. 7. OPEN Requester                                           page 19
  920.  
  921. -----------------------------------------
  922. -----------------------------------------
  923. |       Select a database to open       |
  924. |                                   _   |
  925. |  drawer  XXXXXXXXXXXXXXXXXXXXXXX | |  |
  926. |                                  |X|  |
  927. |  first file                      | |  |
  928. |                                  | |  |
  929. |  second file                     | |  |
  930. |                                  | |  |
  931. |  (dir) first directory           | |  |
  932. |                                  | |  |
  933. |  (dir) second directory          | |  |
  934. |                                  | |  |
  935. |                                   -   |
  936. |  file  XXXXXXXXXXXXXXXXXXXXXXXXXXXXX  |
  937. |                                       |
  938. |    OK                         CANCEL  |
  939. |                                       |
  940. -----------------------------------------
  941.  
  942. This requester (which was written by Charlie Heath and placed in the
  943. public domain) is used when you need to specify a file for DirMaster
  944. to operate on (Yes, I know - never use a preposition to end a sentence
  945. with). The drawer is the disk and directory of the file.  This is
  946. initially the current drive as selected by the Configure-drive option,
  947. but you may enter any valid path.  To select a file, either click on
  948. its name or type the name directly into the "file" gadget.
  949.  
  950.  
  951. 8. Resort Requester
  952.  
  953. -----------------------------------------
  954. |                                       |
  955. |      Select sort fields in order      |
  956. |                                       |
  957. |  NAME  SIZE  DATE  CATEGORY  COMMENT  |
  958. |                                       |
  959. |    OK                         CANCEL  |
  960. |                                       |
  961. -----------------------------------------
  962.  
  963. This requester lets you specify how DirMaster should sort the DISPLAY
  964. list.  By default, records are sorted alphabetically by name. 
  965. However, you may specify any combination and any order of the 5
  966. fields.  For example, clicking on DATE, then NAME, then SIZE will sort
  967. the display list first by date.  Records that have the same dates will
  968. then be sorted by NAME.  Records that have the same dates and names,
  969. will then be sorted by size.  This sort criteria remains in effect
  970. until it is changed again. 
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.                            SHAREWARE PLEA                   page 20
  978.  
  979. Directory Master is a shareware program.  Feel free to give it to your
  980. friends, upload it to your favorite BBS's etc.  However, if you
  981. actually USE this program, please send the $25 registration fee (and
  982. which version you are using and how you got it) to:
  983.  
  984.                               Greg Peters
  985.                               1032 Middy Drive
  986.                               WPAFB, OH 45433
  987.  
  988. In return, you will receive a disk with the latest version of
  989. Directory Master as well as several sample databases (currently Fred
  990. Fish 0-118, Amicus 1-22, Micro Computer Associates (61 disks) and
  991. BIX_28_DEC).
  992.  
  993.  
  994.                            GROUP RATES
  995.  
  996. If you are unwilling to pay $25 for DirMaster, but still want to use
  997. it with a clear conscious, you can get group rates - subject to the
  998. following conditions.  The group (or 1 person in the group) must buy
  999. Directory Master at its regular price ($25).  Then, the group may
  1000. either pay a one-time license fee of $100 or sell DirMaster to its
  1001. users for $5 per copy.  See the options below for full details.  I
  1002. will mail updates ONLY to the original purchaser of Directory Master. 
  1003. I would appreciate receiving a list of group members who will/are
  1004. using Directory Master, although this is optional.  I would like the
  1005. following information to register a group:
  1006.  
  1007.    Group Name
  1008.    Group Location
  1009.    Group Size
  1010.    Name and address of member in charge of distributing Directory
  1011. Master
  1012.  
  1013.  
  1014.                              O P T I O N S
  1015.  
  1016. 1.  Per-copy option:  Directory Master may be distributed to group
  1017. members for $5.00 per copy.  The group member in charge of
  1018. distributing Directory Master will send me a check and list of names
  1019. for every 5 (10?) copies sold.
  1020.  
  1021. 2.  Flat rate option:  Directory Master may be distributed to group
  1022. members for a one time license fee of $100.00 (minimum).  This applies
  1023. to any size group.  In groups that will have more than 50 people
  1024. actually USING Directory Master, I recommend the group decides a price
  1025. they are willing to pay (minimum = $100.00).
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.                             ANY COMMENTS ?                  page 21
  1033.  
  1034. Directory Master evolved into a much better program than I originally
  1035. visualized, mainly due to excellent feedback I have received. 
  1036. Although I did not implement everything, I may eventually release
  1037. another version.  So, please send me any and all suggestions,
  1038. comments, and criticisms you may have.   Thanks.
  1039.  
  1040.  
  1041. Greg Peters
  1042. 1032 Middy Drive
  1043. WPAFB, Ohio 45433
  1044. (513) 254-8391
  1045. BIX: gpeters
  1046.